home *** CD-ROM | disk | FTP | other *** search
- Date: Thu, 28 Mar 91 13:50:22 +0100
- From: Keld J|rn Simonsen <keld@dkuug.dk>
- To: Paul-Pomes@uiuc.edu
- Subject: Installation and Configuration Guide
- X-Charset: ASCII
- X-Char-Esc: 29
-
- Multiple character set support in sendmail is provided by this
- package.
-
- These patches provide support for non-ASCII character sets in
- sendmail. About 90 7- and 8-bit character sets are supported,
- including the ISO 8859 character sets, PC codepages, and Mac character
- set. Actually almost all of the so-called ECMA collection of
- character sets is covered, plus many vendor defined character sets.
-
- Messages are converted to ASCII for transmission, so full
- interoperability and transparancy is guaranteed. It should be noted
- that sending out 8-bit characters in SMTP is a violation of current
- RFC standards and it will create quite unintelligible messages on many
- systems.
-
- The conversion to ASCII is done with a mnemonic representation.
- Recipients without special software will be able to read the message.
- The conversion is fully reversible without information loss, so if
- the receiver has sufficient software and hardware, the message can be
- displayed in the right way.
-
- A conversion filter program 'conv', together with the pager in the
- mail user agent, provides rudimentary support when the hardware is
- available for the recipient.
-
- When mutual agreement has been achieved between two communicating
- systems, these patches can also be used to transmit 8-bit character
- sets. This is useful for instance between UUCP sites, or between
- cooperating sites that send 8-bit mail out over SMTP.
-
-
- Installation of character set support patches to sendmail
-
- [ These and the IDA patches have already been applied to the sendmail
- sources. The character set conversion code is enabled by setting
- #define BIT8 in conf.h -pbp]
-
- The patches have been used for sendmail 5.61, 5.64 and 5.65. They
- will most likely also work on later sendmail versions.
-
- IDA patches are required.
-
- The sendmail patches requires prior installation of the character
- set conversion package. This currently consist of two shar files:
- ch.shar01 and ch.shar02. Create a source directory for these and
- unshar, make and make install the shar files. Default installation
- is in /usr/lib/char, /usr/lib and /usr/include, so you need sufficient
- privileges for these catalogues. The 'conv' program is not installed
- anywhere, but could be copied to /usr/local/bin or similar places
- for public access.
-
- [ In this package, /usr/lib/char is rename to /usr/local/lib/mail/char. ]
-
- Then apply the sendmail patches to the source of sendmail, and
- remake and reinstall sendmail.
-
-
- Configuration
-
- In the ida/cf/Sendmail.mc file, define the local mailer to use the
- internal character set of your machine. If this is, for example,
- ISO 8859-1 (LATIN1) it could be done by:
-
- Mlocal, P=/bin/mail, F=DFMSlmnrs, A=mail -d $u, C=LATIN1, X=29
-
- Valid character set names, and what encodings they cover, are listed
- in the file CHARSETS. The character set is specified with the "C="
- option in the Mailer definition. Case is not significant.
-
- The last parameter above is the compose character for specifying
- out-of-band characters. This can be "&" or a control character.
- The default is ASCII decimal 29 (035, GS), which has the advantage
- of being invisible in the 'more' and 'page' pagers (but not in 'less').
- The compose character is given by the option "X=" followed by the decimal
- ASCII (or other character set) value.
-
- If special arrangements have been made with adjacent UUCP or SMTP sites
- to allow 8bit messages, mailers for them are specified similar to these
- examples.
-
- MUUCP, P=/usr/bin/uux, F=CDFMUVSpu, S=19, R=19, A=uux - -z -r $h!rmail ($u),C=ASCII,X=29
- MUUCP-L1, P=/usr/bin/uux, F=CDFMUSpu, S=19/0, R=19/0, A=uux - -z -r $h!rmail ($u),C=latin1, X=29
- MUUCP-850, P=/usr/bin/uux, F=CDFMUSpu, S=19/0, R=19/0, A=uux - -z -r $h!rmail ($u),C=CP850, X=29
-
- MTCP, P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=ASCII,X=29
- MTCP-L1, P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=LATIN1,X=29
- MTCP-850, P=[IPC], F=CDFMXhnmpu, E=\r\n, A=IPC $h,C=CP850,X=29
-
- Use mailertable to declare the appropriate mailer for those sites.
-
-
- Modifications to IDA sendmail consist of:
-
- 1. New mailer definitions: C for character set, and X for escape char
- in decimal. Appropriate changes to headers.c and sendmail.h .
-
- 2. In collect.c the appropiate mailer for the incoming mail is found
- and if the header "X-Charset" or "X-Char-Esc" is found, these are
- used instead. The header is untouched. The body is converted from
- the found charset to ascii, which is the internal char set of sendmail.
-
- 3. In deliver.c the receiving mailer is determined and the
- corresponding charset is found. This is written with two
- new headers, or if they exist, the old headers are revised.
- Then the body of the message is converted from ascii to
- the receiving character set.
-
- 4. A new routine findheader() has been added in headers.c for locating
- and modifying a header.
-
- 5. The rutine sfgets() in util.c has been changed to allow 8-bit data.
-
- Keld.Simonsen@dkuug.dk 1991-03-24
- (revised Paul-Pomes@uiuc.edu, 1991-04-03)
-